package com.huashi.dealer.modular.business.category.service;


import com.baomidou.mybatisplus.extension.service.IService;
import com.huashi.dealer.commonEntity.Category;
import com.huashi.dealer.modular.business.category.param.CategoryListVo;
import com.huashi.dealer.modular.business.category.param.CategoryResponseParam;

/**
 * API分类服务接口
 * 对应PHP的Category控制器
 *
 * @author 谭陈强
 * @since 2025-07-30
 */
public interface CategoryService extends IService<Category> {

    /**
     * 分类页面 - 对应PHP的index方法
     * 获取分类模板和商品分类列表
     *
     * @return 分类响应参数
     */
    CategoryListVo getCategoryIndex();

    /**
     * 获取商品分类列表
     *
     * @param token    用户token
     * @param parentId 父分类ID
     * @return 分类列表
     */
    CategoryResponseParam getCategoryList(String token, Long parentId);

    /**
     * 获取分类详情
     *
     * @param categoryId 分类ID
     * @param token      用户token
     * @return 分类详情
     */
    CategoryResponseParam getCategoryDetail(Long categoryId, String token);

    /**
     * 获取分类树形结构
     *
     * @return 分类树形结构
     */
    CategoryResponseParam getCategoryTree();
} 